home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / os2 / srefv12i.zip / showdir.doc < prev    next >
Text File  |  1997-01-11  |  3KB  |  58 lines
  1.              The SHOWDIR dynamic directory list processor
  2.  
  3. SRE-Filter's SHOWDIR.CMD is a front-end to the SHOWDIR dynamic directory
  4. list processor, a procedure  developed by Tim Tassonis for the GOHTTP filter.
  5. SHOWDIR is comparable to SRE-Filter's !DIR facility (and to the
  6. GETAFILE add-on), with a few nice tricks, such as the ability to extract the 
  7. contents of .ZIP files (a trick that GETAFILE now supports).
  8. This document briefly discusses how to use SHOWDIR.CMD in the SRE-Filter
  9. environment.
  10.  
  11. *) The first point is that, unlike !DIR, SHOWDIR does NOT work well
  12.    as a stand along "directory display" tool.  Although it is possible
  13.    to call it directly, it is best used to resolve "directory only"
  14.    URLS (that is, URL's that end with a /).
  15.  
  16. *)  SHOWDIR can use the contents of HTACCESS files
  17.     (i.e.; to dictate file exclusion).  Note that SHOWDIR will look for
  18.     an HTACCESS file even if you are NOT using HTACCESS for access control
  19.     (that is, even if DO_HTACCESS='NO') --  SHOWDIR merely extract the
  20.     "dynamic directory" variables from the HTACCESS file, and pays no
  21.     attention to the access control, redirection, and default index
  22.     parameters.   Of course, if there is no HTACCESS file specified
  23.     then SHOWDIR will not attempt to find one.
  24.  
  25. *)  Basically, the best way to use SHOWDIR is to include:
  26.         !SHOWDIR
  27.     in either the AUTO_NAME variable, or in the defaultindex parameter
  28.     in the HTACCESS file.  This is similar to the !CREATE option,
  29.     but instead of invoking !DIR, it invokes SHOWDIR.
  30.  
  31. *)  For more details on the use of HTACCESS files, see:
  32.       http://w3.ag.uiuc.edu/DLM/GoHTTP/Submissions/
  33.  
  34. *)  And most importantly, to obtain the SHOWDIR package, see:
  35.        http://w3.ag.uiuc.edu/DLM/GoHTTP/Submissions/tt/showdir.zip
  36.  
  37. *)  Note to GOHTTP mavens: the DIR.BUILDER parameter in HTACCESS files is
  38.     ignored by SRE-Filter.
  39.  
  40. *)  Hint: _Dir.Exclude or Dir.exclude HTACCESS parameter can be used 
  41.      to suppress display of sensitive files.  For example:
  42.          _DIR.EXCLUDE: filename.ext fes.htm *.gif pic86.htm filenam2.ext
  43.  
  44. *)  Hint: the Dir.Describe parameter can be used to provide file-by-file
  45.     descriptions.  For example:
  46.           Dir.Describe: descript.txt
  47.     The "descript.txt" file should have the form:
  48.         filename.1   a description
  49.         filename.2  a description
  50.     where filename.n should NOT contain path information.
  51.     Note that descript.txt file is only used for files in the same directory.
  52.     
  53. *)  CAUTION: The DIR.Info parameter (that display a header file) assumes
  54.     HTML code -- if you header file contains plain text, it will NOT
  55.     be formatted (it will be  displayed as one paragraph).
  56.  
  57.  
  58.